home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 4 / Meeting Pearls Vol. IV (1996)(GTI - Schatztruhe)[!].iso / Pearls / gfx / Viewer / CyberAnim / CyberAnim.doc < prev    next >
Text File  |  1996-09-08  |  7KB  |  232 lines
  1.  
  2.         CYBERANIM IFF/ANIM-format Animation Player v1.0           8 Sep 1996
  3.         -----------------------------------------------
  4.  
  5.  
  6. This program plays IFF ANIM3/5/7-format bitmapped animation files on
  7. any Amiga+GfxCard with OS3.0 or higher and CyberGraphX V2.18 (40.89)
  8. or higher.
  9.  
  10. In general, it can play any IFF ANIM3/5/7-format animation in a
  11. different screen mode than intended.  It is most useful for playing
  12. AGA 256-colour animations on an ECS Amiga with a gfx-card.
  13.  
  14. The files in this archive may be distributed anywhere provided they are
  15. unmodified and are not sold for profit.
  16.  
  17. Ownership and copyright of all files remains with the author:
  18.  
  19.     Peter McGavin, 86 Totara Crescent, Lower Hutt, New Zealand.
  20.     e-mail: p.mcgavin@irl.cri.nz (unable to answer mail until mid October)
  21.  
  22.  
  23.  
  24. FEATURES:
  25. ---------
  26.  
  27. Uses an Intuition-friendly Screen.  You can flip it to the back with
  28. left-Amiga M, while an animation is playing.
  29.  
  30. Plays either from ram or directly from disk.  Falls back to disk play
  31. when not enough ram is available.
  32.  
  33. Uses an ASL ScreenMode requester.
  34.  
  35. Supports Extra-Half-Brite (EHB) animations.
  36.  
  37. Uses a double-height Screen and ScrollVPort() for double-buffering.
  38. Dragging the Screen up and down (left Amiga left mouse button drag)
  39. will reveal both buffers.  Note that this method of double-buffering
  40. mightn't work properly before CyberGraphX V2.18 (40.89).  Make sure
  41. you have an up to date version of CyberGraphX or you might see only
  42. every second frame.
  43.  
  44. Renders to fastmem bitplanes, then blits to the Screen using gfx-card
  45. friendly BltBitMapRastPort().  Blits only the parts of each frame that
  46. changed since the previous frame (actually the 2nd-previous frame).
  47.  
  48. Runs from either icon or shell.  Uses icon tooltypes for options (i.e,
  49. WorkBench Icons/Information... menu item).
  50.  
  51. Playback speed can be controlled with F-keys.
  52.  
  53. Source code is included, so if something doesn't work you can fix it.
  54.  
  55.  
  56.  
  57. LIMITATIONS:
  58. ------------
  59.  
  60. Does not support HAM or HAM8 in CyberGraphX modes (although they can
  61. be played in the wrong colours).
  62.  
  63. Double-buffering is not synchronised with the gfx-card video beam in
  64. CyberGraphX modes.  There seems to be no supported way of doing this.
  65. My experiments seem to indicate that WaitTOF() still uses the native
  66. chipset vblank, which is out of step with the gfx-card vblank.  If
  67. flicker is a problem, as it is with certain animations on my GVP
  68. Spectrum gfx-card, try using the WAITTOF option or try "setenv
  69. CYBERGRAPHICS/CPUP2C 1".  However these will slow down animations and
  70. other graphics operations.
  71.  
  72. Palette changes are not synchronised with the CyberGraphX video beam
  73. either, so animations with palette changes may flicker too.
  74.  
  75. CYBERANIM doesn't cope with all anim7-format files, e.g, if the first
  76. frame is a DLTA chunk instead of a BODY chunk.
  77.  
  78. When looping an animation, CYBERANIM assumes the last 2 frames restore
  79. the first 2 frames exactly.  If that is not the case, the animation
  80. may jitter and/or garbage may appear on the display the 2nd and
  81. subsequent times around.
  82.  
  83. CYBERANIM does not support masks, colour ranges or sound.  CYBERANIM
  84. ignores unrecognised IFF chunks.
  85.  
  86. Some corrupt anim files may crash CYBERANIM (although most won't).
  87.  
  88.  
  89.  
  90. OPERATION:
  91. ----------
  92.  
  93. I've tried to make CYBERANIM easy to use in many different ways.
  94.  
  95. Just double-click the CYBERANIM icon and select an anim to play from the
  96. requester.
  97.  
  98. Alternatively you can set up project icons for your anims (e.g, with
  99. IconEdit).
  100.  
  101. Options can be specified either on the commandline or in icon
  102. tooltypes.  You can set default tooltypes in the program icon and
  103. override them temporarily with tooltypes in any project icon.
  104.  
  105. From the SHELL or CLI, the syntax is:
  106.  
  107.  
  108.    CYBERANIM FILE/M,DISK/S,RAM/S,ONCE/S,WARP/S,NOMODEREQ/S,WAITTOF/S
  109.  
  110.  
  111. If you don't specify a file, the file-requester pops up.
  112.  
  113. You can specify a list of files, separated by spaces.  However #?
  114. wildcards don't work.
  115.  
  116. Options are:
  117.  
  118.     DISK:               Plays from disk (i.e, plays while reading).
  119.  
  120.     RAM (default):      Plays from RAM (i.e, loads first, then plays).
  121.  
  122.     ONCE:               Play once, then quit.  (Default is to loop).
  123.  
  124.     WARP:               Plays real fast.  Default speed is what anim says.
  125.  
  126.     NOMODEREQ:          Tries to guess the best Screen mode to use.
  127.  
  128.     WAITTOF:            Attempt to avoid flicker.
  129.  
  130.  
  131.  
  132. KEYBOARD AND MOUSE CONTROLS
  133. ---------------------------
  134.  
  135. To quit an animation, press ESC or Q or click the right mouse button.
  136. CYBERANIM also stops when it receives a CTRL/C break signal, e.g, by
  137. typing CTRL/C in the Shell window or by using the AmigaDOS BREAK
  138. command.
  139.  
  140. Keys F1 through F10 can be used to change animation speed as follows:
  141.  
  142.    F1   as fast as possible
  143.    F2   60 frames per second
  144.    F3   30 frames per second
  145.    F4   24 frames per second
  146.    F5   15 frames per second
  147.    F6   12 frames per second
  148.    F7   10 frames per second
  149.    F8   5 frames per second
  150.    F9   1 frame per second
  151.    F10  at the speed specified in the anim file
  152.  
  153.  
  154.  
  155. WHY IS CYBERANIM SO SLOW?
  156. -------------------------
  157.  
  158. Have you tried the WARP option or pressed F1 yet?  The default is to
  159. play at the speed defined in the anim file, which is often quite slow.
  160.  
  161. What kind of Amiga do you have?  CYBERANIM is significantly faster on
  162. faster Amigas.  Fast memory helps a lot too.
  163.  
  164. What resolution is the anim file?  320x200 is up to 5 times faster
  165. than 640x512.
  166.  
  167. In CyberGraphX modes, CYBERANIM unpacks each frame to a temporary
  168. buffer in fastmem then blits that buffer to the Screen.  Since
  169. BltBitMapRastPort() blits only rectangles (BltMaskBitMapRastPort()
  170. seems to be slower), CYBERANIM generally blits more than the parts
  171. that changed since the previous frame.
  172.  
  173. Other animation players (and CYBERANIM using native modes) unpack each
  174. frame directly to the Screen.  The latter method is faster but it is
  175. not compatible with gfx-cards.  On the other hand, CYBERANIM does not
  176. use slow chipmem at all in CyberGraphX modes.
  177.  
  178. Anim-format is exactly the wrong format for chunky gfx-cards.  That
  179. is, everything is stored internally in "planar" format, but the
  180. gfx-card has its graphics video-memory arranged in "chunky" format.
  181. Algorithms to convert between chunky and planar format are slow.
  182.  
  183. CYBERANIM uses the conversion algorithms built in to CyberGraphX to
  184. convert from planar to chunky.  CyberGraphX uses the gfx-card's
  185. hardware for this if the environment variable CYBERGRAPHICS/CPUP2C is
  186. set to 0, otherwise it uses a software algorithm.
  187.  
  188. Note also that animations with less than 8 bitplanes play faster than
  189. 8 bitplane animations in native modes, but not necessarily in
  190. CyberGraphX modes.  That's because there is less memory to move around
  191. with less bitplanes in planar modes.  This is an advantage planar has
  192. over chunky and one of the reasons Amigas have always been so good at
  193. animation.
  194.  
  195.  
  196.  
  197. BUGS:
  198. -----
  199.  
  200. Bugs?  What bugs?  Well there probably are bugs because I only started
  201. writing this program a few days ago and it hasn't been extensively
  202. tested yet.
  203.  
  204.  
  205.  
  206. THANKS:
  207. -------
  208.  
  209. Thanks to Frank Mariak and the rest of the CyberGraphX team for
  210. CyberGraphX.  (By the way, I am not associated with CyberGraphX
  211. development, just a satisfied user...)
  212.  
  213.  
  214.  
  215. DISCLAIMER:
  216. -----------
  217.  
  218. It seems to work for me.  Tested on:
  219.  
  220.     A3000 + 40MHz Warp engine + GVP Spectrum EGS & CyberGraphX
  221.  
  222.     A4000/040 + CyberVision64 & CyberGraphX
  223.  
  224.  
  225.  
  226. HISTORY:
  227. --------
  228.  
  229. v1.0    8 Sep 1996
  230.  
  231. First release.
  232.